home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / pmnewcontext.z.z / pmnewcontext.z / pmnewcontext
Text File  |  1997-04-03  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMNNNNEEEEWWWWCCCCOOOONNNNTTTTEEEEXXXXTTTT((((3333))))                                                PPPPMMMMNNNNEEEEWWWWCCCCOOOONNNNTTTTEEEEXXXXTTTT((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt - establish a new PMAPI context
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.  
  14.      iiiinnnntttt ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt((((iiiinnnntttt ttttyyyyppppeeee,,,, cccchhhhaaaarrrr ****nnnnaaaammmmeeee))))
  15.  
  16.      cccccccc ............ ----llllppppccccpppp
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      An application using the Performance Metrics Application Programming
  20.      Interface (PMAPI) may manipulate several concurrent contexts, each
  21.      associated with a source of performance metrics, e.g. ppppmmmmccccdddd(1) on some
  22.      host, or an archive log of performance metrics as created by ppppmmmmllllooooggggggggeeeerrrr(1).
  23.  
  24.      ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt may be used to establish a new context.  The source of the
  25.      metrics is identified by _n_a_m_e, and may be either a host name (_t_y_p_e _i_s
  26.      PPPPMMMM____CCCCOOOONNNNTTTTEEEEXXXXTTTT____HHHHOOOOSSSSTTTT), or the base name for the files of an archive log (_t_y_p_e
  27.      is PPPPMMMM____CCCCOOOONNNNTTTTEEEEXXXXTTTT____AAAARRRRCCCCHHHHIIIIVVVVEEEE).  The initial instance profile is set up to select
  28.      all instances in all instance domains, and the collection time is the
  29.      current time of each request for a host, else zero for an archive.  In
  30.      the case of an archive, the initial collection time will result in the
  31.      earliest set of metrics being returned from the archive at the first
  32.      ppppmmmmFFFFeeeettttcccchhhh(3).
  33.  
  34.      Once established, the association between a context and source of metrics
  35.      is fixed for the life of the context, however routines are provided to
  36.      independently manipulate both the instance profile (see ppppmmmmAAAAddddddddPPPPrrrrooooffffiiiilllleeee(3)
  37.      and ppppmmmmDDDDeeeellllPPPPrrrrooooffffiiiilllleeee(3)) and the collection time (see ppppmmmmSSSSeeeettttMMMMooooddddeeee(3))
  38.      components of a context.
  39.  
  40.      ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt returns a handle that may be used with subsequent calls to
  41.      ppppmmmmUUUUsssseeeeCCCCoooonnnntttteeeexxxxtttt(3).
  42.  
  43.      The new context remains the current PMAPI context for all subsequent
  44.      calls across the PMAPI, until another call to ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt(3) is made, or
  45.      the context is explicitly changed with a call to ppppmmmmDDDDuuuuppppCCCCoooonnnntttteeeexxxxtttt(3) or
  46.      ppppmmmmUUUUsssseeeeCCCCoooonnnntttteeeexxxxtttt(3), or destroyed using ppppmmmmDDDDeeeessssttttrrrrooooyyyyCCCCoooonnnntttteeeexxxxtttt(3).
  47.  
  48.      When attempting to connect to a remote ppppmmmmccccdddd(1) on a machine that is
  49.      booting, ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt could potentially block for a long time until the
  50.      remote machine finishes its initialisation.  ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt will abort and
  51.      return an error if the connection has not been established after some
  52.      specified interval has elapsed.  The default interval is 5 seconds.  This
  53.      may be modified by setting PPPPMMMMCCCCDDDD____CCCCOOOONNNNNNNNEEEECCCCTTTT____TTTTIIIIMMMMEEEEOOOOUUUUTTTT in the environment to a
  54.      real number of seconds for the desired timeout.  This is most useful in
  55.      cases where the remote host is at the end of a slow network, requiring
  56.      longer latencies to establish the connection correctly.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMNNNNEEEEWWWWCCCCOOOONNNNTTTTEEEEXXXXTTTT((((3333))))                                                PPPPMMMMNNNNEEEEWWWWCCCCOOOONNNNTTTTEEEEXXXXTTTT((((3333))))
  71.  
  72.  
  73.  
  74. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  75.      PPPPMMMMCCCCDDDD____CCCCOOOONNNNNNNNEEEECCCCTTTT____TTTTIIIIMMMMEEEEOOOOUUUUTTTT
  76.           Timeout period (in seconds) for ppppmmmmccccdddd(1) connection attempts.
  77.  
  78.      PPPPMMMMCCCCDDDD____PPPPOOOORRRRTTTT
  79.           TCP/IP port for connecting to ppppmmmmccccdddd(1), defaults to 4321.
  80.  
  81. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  82.      ppppmmmmAAAAddddddddPPPPrrrrooooffffiiiilllleeee(3), PPPPMMMMAAAAPPPPIIII(3), ppppmmmmDDDDeeeellllPPPPrrrrooooffffiiiilllleeee(3), ppppmmmmDDDDeeeessssttttrrrrooooyyyyCCCCoooonnnntttteeeexxxxtttt(3),
  83.      ppppmmmmDDDDuuuuppppCCCCoooonnnntttteeeexxxxtttt(3), ppppmmmmRRRReeeeccccoooonnnnnnnneeeeccccttttCCCCoooonnnntttteeeexxxxtttt(3), ppppmmmmSSSSeeeettttMMMMooooddddeeee(3), ppppmmmmUUUUsssseeeeCCCCoooonnnntttteeeexxxxtttt(3) and
  84.      ppppmmmmWWWWhhhhiiiicccchhhhCCCCoooonnnntttteeeexxxxtttt(3).
  85.  
  86. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  87.      PPPPMMMM____EEEERRRRRRRR____PPPPEEEERRRRMMMMIIIISSSSSSSSIIIIOOOONNNN
  88.  
  89.           No permission to perform requested operation
  90.  
  91.      PPPPMMMM____EEEERRRRRRRR____CCCCOOOONNNNNNNNLLLLIIIIMMMMIIIITTTT
  92.  
  93.           PMCD connection limit for this host exceeded
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.